home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / message / msgbx / readme.txt < prev    next >
Encoding:
Text File  |  1995-07-07  |  8.3 KB  |  176 lines
  1.  
  2.  
  3.  
  4.                 M E S S A G E    B O X    D E S I G N E R
  5.  
  6.  
  7.                                    by
  8.                              Gordon Burnham
  9.                            631 Iroquois Avenue
  10.                         Louisville, KY 40214-1226
  11.                                   USA
  12.                            Tel (502) 366-7833
  13.  
  14.  
  15.       MESSAGE BOX DESIGNER Copyright (c) Gordon Burnham 1994.  All rights
  16.       reserved.  MESSAGE BOX DESIGNER is a proprietary computer software
  17.       product provided by its copyright holder, Gordon Burnham (631
  18.       Iroquois Avenue, Louisville, KY); both the software and its
  19.       documentation are copyrighted, and you may not copy or use either
  20.       except as expressly provided in writing by Gordon Burnham.
  21.  
  22.       MESSAGE BOX DESIGNER for Windows, Version 1.9, is offered on a
  23.       shareware (try before you buy) basis.  If you find this program
  24.       useful and/or use it after a 30-day trial period, you are
  25.       expected to register it with the author.  Registration is $15
  26.  
  27.       MESSAGE BOX DESIGNER is written in Visual Basic and therefore will
  28.       require the 'VBRUN300.DLL' which comes with Visual Basic.  If you
  29.       have an older version, you can get this one from the MSBASIC
  30.       forum on Compuserve.  If you have problems with the VBX, try
  31.       putting it in your 'windows\system' directory. You will also need
  32.       the THREED.VBX which ships with the Professional version.  This
  33.       is also available from the MSBASIC forum on Compuserve.
  34.  
  35.       If you use Visual Basic Constants, you will need to include
  36.       'CONSTANT.TXT' that Microsoft ships with Visual Basic.  It
  37.       appears that Microsoft forgot to include a couple of constants
  38.       in the 'CONSTANT.TXT' file, so you will need to add them.  They
  39.       can be found under the 'MsgBox Function' in the Language
  40.       Reference book and are shown here for your convenience.
  41.  
  42.                      Global Const MB_APPLMODAL = 0
  43.                      Global Const MB_SYSTEMMODAL = 4096
  44.  
  45.       MESSAGE BOX DESIGNER is a utility designed for Visual Basic
  46.       programmers.  It a very handy mechanism for creating "Message
  47.       Boxes".  It allows you to build a message box, test it, modify
  48.       and test again until you get it right.  You can then paste the
  49.       code into a function or subroutine.
  50.  
  51.       I have found it very useful for creating message boxes for User
  52.       approval.  It makes it very easy to create, 'screen print' and
  53.       place into a Word for Windows document.  Several variations can
  54.       be done this way very quickly to determine the best for a certain
  55.       situation.
  56.  
  57.       A number of programmers have told me that what they like most
  58.       about MESSAGE BOX DESIGNER is that they don't have to remember
  59.       or look up the codes for the buttons, icons, setting the default
  60.       button, return values from the button clicked or how to make
  61.       the message box application modal or system modal.
  62.  
  63.       Essentially, you create the message box, test it, when it's the
  64.       way you want it, click the 'Copy to Clipboard' button, go to the
  65.       place in your code where you want the message box and perform a
  66.       paste.  Voila!  The complete code for the message box is there,
  67.       requiring only that you enter the code for the appropriate
  68.       response to the buttons chosen for the particular message box.
  69.  
  70.  
  71.       NOTES ABOUT USE:
  72.  
  73.       This readme file is the only documentation for MESSAGE BOX DESIGNER
  74.       since, for even novice Visual Basic programmers, it is fairly
  75.       obvious how to use it.  The following information is provided so
  76.       that you don't have to experiment to find out how they work, but
  77.       you'll probably want to do that anyway!
  78.  
  79.       When building the message box, you have several options for how
  80.       you want the code to be generated.
  81.  
  82.       1.  Use Visual Basic Constants - checking this will cause the
  83.           code to be generated with VB constants.  You will need to
  84.           make sure that 'Contant.Txt' (shipped with Visual Basic)
  85.           is included in a code module.  If unchecked, then actual
  86.           numbers will be used.
  87.  
  88.       2.  No variables - checking this will cause the message box
  89.           'text' and message box title to appear as string literals
  90.           in the "MsgBox" call.
  91.  
  92.       3.  Variables WITH DIM statements.  This will add the "Dim
  93.           MBMsg$, MBTitle$" line to the generated code and the
  94.           variables 'MBMsg$' and 'MBTitle$' will be used to hold
  95.           the 'text' & 'title' strings.  If you have already used
  96.           variable declarations within the Function or Subroutine,
  97.           you will get a VB error message telling you the
  98.           declaration is a "duplicate declaration", so you will want
  99.           to watch out for this.
  100.  
  101.       4.  Variables WITHOUT DIM statements - The line "Dim MBMsg$,
  102.           MBTitle$" will not be included in the code.  The variables
  103.           'MBMsg$' and 'MBTitle$' will be used to hold the 'text'
  104.           and 'title' strings.
  105.  
  106.       You can add a 'Beep' signal to the message box code if you wish.
  107.  
  108.       The message box can be made Application Modal or System Modal as
  109.       you desire.  Application Modal means the user can't select
  110.       anything else in the application, but can select other programs
  111.       and do other things in windows.  System Modal means your user
  112.       can't do anything else until they respond to the message.
  113.  
  114.       Message boxes can be generated using different combinations of
  115.       these items to suit your particular preference.
  116.  
  117.       NEW FEATURES in Ver. 1.9
  118.       ========================
  119.  
  120.       Message Box Maker uses the MsgBox Function in all cases except
  121.       when the 'OK' button is the only one desired.  It then uses the
  122.       MsgBox Statement instead (no 'Case' statements).
  123.  
  124.       The "Show Code" button on the 'Code' tab opens a window and
  125.       displays the code as it will appear in your Visual Basic Code
  126.       window.  If you can't see the entire code, use the vertical and
  127.       horizontal scroll bars to move around to view the entire code.
  128.  
  129.       Carriage returns can now be embedded in the Message Box text by
  130.       pressing <Ctrl><ENTER> keys.  This will permit formatting of
  131.       the text in the message box window to your liking instead of
  132.       defaulting to the way windows handles it.
  133.  
  134.       Tabs can be embedded in the Message Box text by pressing <Ctrl>
  135.       <TAB> keys.  You can't use the <TAB> key alone, because it will
  136.       simply tab to the next active control in the Tab Order.
  137.  
  138.       NOTE:  Something I do frequently is embed variables in the
  139.       Message Box text.  The message box will not display correctly in
  140.       test mode when you do this, however, it will work correctly when
  141.       called within Visual Basic code.  To embed variables, you must
  142.       do it the following way:
  143.  
  144.               <...your message box text> " + <variable> + "
  145.                                - OR -
  146.               <...your message box text> " + <variable> + "<more text>
  147.  
  148.       The important thing to note is that there must be a double quote
  149.       and a plus sign (" +) preceeding the variable name and a plus
  150.       sign and a double quote (+ ") following the variable name.  The
  151.       part following the variable is required whether you have
  152.       additional text or not due to the way the message box function
  153.       parameters are built so that VB sees it correctly as a
  154.       combination of 'Code' and 'Strings'.
  155.  
  156.       Using this technique, you can do something like this:
  157.  
  158.                    Staff Account:  0052019
  159.  
  160.       A refresh diskette will be created for this account!
  161.       Is this what you want to do?
  162.  
  163.                          Yes       No
  164.  
  165.       A <Ctrl Tab> is entered first then the text 'Staff Account:  '
  166.       followed by " + StaffAcctNum.Text + " then <Enter><Enter> and
  167.       the rest of the text.  It won't look right in the test, but it
  168.       will appear correctly when you paste the code into your module
  169.       and run the application.
  170.  
  171.       Micro-Help is now displayed in the status bar at the bottom of
  172.       the window as the mouse pointer is moved over the form.
  173.  
  174.       ===============================================================
  175.                             END OF README.TXT
  176.       ===============================================================